10.3 Die Klasse »StringBuilder« 

10.3.1 Allgemeines 

Objekte der Klasse String sind unveränderlich, d.  h., dass bei jeder String-Operation neuer Speicher allokiert wird, in den das geänderte String-Objekt geschrieben wird. Das ist sogar unabhängig davon, ob sich die Länge der Zeichenkette ändert. Führen Sie viele manipulierende Operationen aus, hat das Einbußen der Systemleistung zur Konsequenz.

Um sich einen Eindruck zu machen, wie sehr die Effizienz bei vielen String-Operationen beeinträchtigt wird, lassen wir in einer Schleife 50000 Änderungen an einer Zeichenfolge vornehmen. Folgerichtig müssen auch ebenso viele neue Objekte erzeugt und, bis auf das letzte, freigegeben werden.

Probieren Sie das Codefragment ruhig einmal aus! Auch auf einem gut ausgestatteten Rechner werden die Operationen eine längere Zeitspanne beanspruchen, bis das Ergebnis vorliegt.

Einen Ausweg aus diesem Dilemma bietet die Klasse StringBuilder, die zum Namespace System.Text gehört. StringBuilder-Objekte sind dynamisch. Sie können verändert werden, ohne dass damit zwangsläufig eine Neuallokierung von Speicher erforderlich wird.

Natürlich interessiert uns auch der Performancegewinn. Daher schreiben wir das Codefragment von oben so um, dass anstelle des Typs String die Klasse StringBuilder eingesetzt wird.

Der Leistungsgewinn ist deutlich zu erkennen und beweist, welchem Typ der Vorzug gegeben werden sollte: eindeutig dem StringBuilder.

10.3.2 Die Kapazität eines »StringBuilder«-Objekts 

Sie müssen zwei Begriffe sorgfältig trennen, wenn Sie die Arbeitsweise dieses Objekttyps verstehen wollen: die Kapazität und die Länge der beschriebenen Zeichenfolge. Die Kapazität beschreibt die maximale Anzahl der Zeichen, die ein StringBuilder-Objekt enthalten kann. Die Kapazität kann also größer sein als die Länge der Zeichenfolge, aber nicht umgekehrt.

Nehmen wir dazu ein Beispiel. Wir erzeugen mit einem der Konstruktoren ein StringBuilder-Objekt und weisen ihm die Zeichenfolge »Visual Basic« zu:

Die Zeichenfolge ist neun Zeichen lang. Da wir keine explizite Aussage über die Kapazität getroffen haben, wird ein Objekt von der Größe der Standardkapazität erzeugt – und die beträgt 16 Zeichen. Weisen Sie dem StringBuilder-Objekt eine Zeichenkette zu, die mehr als 16 Zeichen, jedoch weniger als 33 Zeichen umfasst, wird die Kapazität auf 32 Zeichen festgelegt. Beträgt die Länge des Strings mehr als 32 Zeichen, jedoch weniger als 65, verdoppelt sich die Kapazität von 32 auf 64 Zeichen usw.

Werden Methoden auf dieses Objekt angewendet, die zur Folge haben, dass die Kapazitätsgrenze nicht überschritten wird, wird kein neuer Speicher allokiert. Die Änderungen laufen innerhalb der alten Speicherressourcen ab. Sollten bei einer Änderung jedoch die Kapazitätsgrenzen überschritten werden, wird die Kapazität des StringBuilder-Objekts automatisch vergrößert.

10.3.3 Die Konstruktoren der Klasse »StringBuilder« 

Vornehmlich geht es bei den Konstruktoren darum, dem StringBuilder-Objekt eine Initialisierungszeichenfolge zuzuweisen und die Anfangskapazität festzulegen.

Bei der Festlegung der Kapazität im Parameter vom Typ Integer müssen Sie sich nicht an die Sprünge 16, 32, 64, 128 usw. halten, die das StringBuilder-Objekt im Bedarfsfall automatisch durchführt. Theoretisch kann eine Zeichenfolge die Größe von 2³¹   – 1 Zeichen aufnehmen. Um diesem nahezu endlosen Spiel einen Riegel vorzuschieben, bietet sich ein weiterer Konstruktor an, mit dem Sie die maximale Kapazitätsgrenze festlegen können:

Der erste Parameter erwartet die Startkapazität, der zweite die zulässige Maximalgröße. Wird diese zur Laufzeit überschritten, wird die Ausnahme ArgumentOutOfRangeException ausgelöst.

10.3.4 Die Eigenschaften der Klasse »StringBuilder« 

Die Liste der Eigenschaften umfasst nur insgesamt vier Mitglieder.

Mit Capacity können Sie die aktuelle Kapazität abfragen, setzen oder auch verringern. Zu verwechseln ist Capacity nicht mit der Eigenschaft Length, die, wie schon von der Klasse String her bekannt, die Anzahl der Zeichen der vom Objekt repräsentierten Zeichenfolge wiedergibt.

MaxCapacity gibt die äußerste Maximalgröße des StringBuilder-Objekts wieder. Diese Eigenschaft ist schreibgeschützt und kann daher auch nur gelesen werden. Einzig und allein über die Konstruktoren sind Sie in der Lage, Einfluss auf dieses Charakteristikum auszuüben. Haben Sie MaxCapacity nicht definiert, liefert diese Eigenschaft den Maximalwert dieses Typs (2³¹   – 1) zurück.

Die vierte und letzte Eigenschaft lautet Chars und ist parametrisiert:

Chars liefert ein Zeichen aus der gegebenen Zeichenfolge zurück, dessen Index Sie der Parameterliste übergeben. Auch bei der Indizierung der Zeichen eines StringBuilder-Objekts ist der erste Index auf 0 festgelegt. Wenn Sie sich aus der Zeichenfolge

den fünften Buchstaben zurückgeben lassen wollen, müssen Sie folgende Anweisung schreiben:

Auf die explizite Angabe der Eigenschaft Chars können Sie verzichten, da sie Default deklariert ist.

In der folgenden Tabelle finden Sie alle Eigenschaften der StringBuilder-Klasse zusammen aufgeführt.

10.3.5 Die Methoden der Klasse »StringBuilder« 

Wenn Sie sich zum ersten Mal die Liste der Methoden anschauen, werden Sie erstaunt sein, dass entgegen aller Erwartungen nur kaum mehr als eine Hand voll Operationen angeboten wird. Diese wollen wir uns nun ansehen.

Zuweisung einer Zeichenkette an ein »StringBuilder«-Objekt

Soll einem StringBuilder-Objekt eine Zeichenfolge zugewiesen werden, kommt die Methode Append zum Einsatz, der aufgrund der vielen Überladungen praktisch jeder Datentyp übergeben werden kann:

In den meisten Fällen wird dies vermutlich eine Zeichenfolge sein, z.  B.:

Der Rückgabewert der Append-Methode ist die Referenz auf ein Objekt vom Typ StringBuilder, das die entsprechende Zeichenfolge enthält. Sie müssen Append auch aufrufen, wenn eine Referenz auf ein Objekt vom Typ StringBuilder vorliegt, das noch nicht initialisiert ist. Wenden Sie Append mehrfach hintereinander an, wird bei jedem Aufruf der Methode eine weitere Zeichenfolge hinter die bestehende angehängt. Das entspricht dem »+«-Operator auf String-Objekte.

Halten Sie sich immer vor Augen, dass ein StringBuilder-Objekt keine Zeichenfolge repräsentiert – dafür dient der Datentyp String. Wollen Sie sich den Inhalt eines StringBuilder-Objekts von einer Methode ausgeben lassen, die den Datentyp String als Übergabeparameter erwartet, müssen Sie deshalb mit der Methode ToString das StringBuilder-Objekt in einen String konvertieren.

Einfügen einer Zeichenfolge

Um an einer spezifizierten Position in einer Zeichenfolge eine zusätzliche einzufügen, rufen Sie die Insert-Methode auf. Diese ist in gleicher Weise wie Append überladen, allerdings ist die Parameterliste jeweils um einen Parameter vom Typ Integer ergänzt, der dem Index übergeben wird, ab dem die Zeichenfolge eingefügt werden soll.

Die Ausgabe dieses Codefragments lautet:

Löschen aus einer Zeichenfolge

Während mit Insert eine Zeichenfolge eingefügt wird, kann mit Remove ab einer bestimmten Position eine bestimmte Anzahl von Zeichen gelöscht werden.

Mit dem ersten Parameter wird der Index beschrieben, bei dem der Löschvorgang beginnen soll, hier also beginnend mit dem vierten Zeichen. Über den zweiten Parameter teilen wir die Anzahl der zu löschenden Zeichen mit.

Ersetzen eines Zeichens oder einer Zeichenfolge

Die letzte der von uns behandelten Methoden ist Replace, die im Wesentlichen dieselben Möglichkeiten wie die Replace-Methode der Klasse String bietet.

Dem ersten Parameter wird mitgeteilt, welches Zeichen bzw. welche Zeichenfolge des StringBuilder-Objekts ersetzt werden soll, im zweiten Parameter sagen Sie, wodurch ersetzt wird.

Sie sehen, mit Replace können Sie sogar vermeiden, mangels Flüssigkeitszufuhr aufgrund einer unüberlegt aufgegebenen Bestellung zu verdursten.

10.3.6 Allgemeine Anmerkungen 

Damit sind aber auch schon die Möglichkeiten der Klasse StringBuilder nahezu ausgeschöpft. Es gibt keine Methoden, die das Auswerten eines Teilstrings ermöglichen, oder Methoden, die Teilstrings zurückliefern. Damit wird auch der doch recht eingeschränkte Einsatzbereich von StringBuilder-Objekten deutlich. Die Klasse String ist in ihren Fähigkeiten weit voraus, lässt mit ihren überladenen Methoden kaum Wünsche offen.

StringBuilder-Objekte werden Ihnen nicht sehr oft begegnen. Die meisten Methoden in der .NET-Klassenbibliothek, die mit Zeichenfolgen operieren, verwenden Referenzen des Typs String oder Arrays vom Typ Char. Am ehesten sind StringBuilder-Objekte dort sinnvoll einzusetzen, wo in einer Schleife bei jedem Schleifendurchlauf eine Operation mit der Zeichenfolge ausgeführt wird. Wenn die Kapazität des StringBuilder-Objekts groß genug festgelegt worden ist, ersparen Sie sich zudem die permanente Neuinstanziierung von String-Objekten und können so einen Beitrag zu einer besseren Performance der Anwendung leisten.